Skip to main content

Linux Deployment

This guide provides step-by-step instructions to deploy SyncNow on a Linux machine.

SyncNow runs as a systemd service and requires a dedicated system user (syncnow). The installation process requires sudo privileges.

Prerequisites

  • Root or sudo privileges are required to install and manage the service.
  • Ensure unzip is installed on your system.
  • If using PostgreSQL or SQL Server, ensure the database is set up beforehand.

Extract the Installation Package

Extract the SyncNow compressed archive:

unzip "/home/ec2-user/Linux64-SyncNow.zip" -d ~/SyncNowSetup

Installation

Step 1: Database Setup

SyncNow supports SQLite (default), PostgreSQL, or SQL Server (MSSQL).

For the Internal Database (SQLite)

No additional configuration is required.

For SQL Server or PostgreSQL

  1. Create a database user for SyncNow.
  2. Create a database and grant full ownership to the SyncNow user.

Step 2: Install SyncNow

  1. Change to the setup directory:

    cd ~/SyncNowSetup

  2. Grant execution permissions and install SyncNow:

    chmod +x Install.sh
sudo ./Install.sh Install

  3. Accept the license agreement by pressing Y when prompted.

  4. If using PostgreSQL or SQL Server, configure the database settings in /opt/SyncNow/appsettings.json:

    • Set the DatabaseType (options: SQLite, SQLServer, PostgreSQL).
    • Configure DatabaseHost, DatabaseName, DatabasePort, DatabaseUser, and DatabasePassword.
    • The password will be encrypted after the first load.
    • If using TLS/SSL encryption, set Encrypt to True.
    • If using Windows Authentication (MSSQL only), set WindowsAuth to True (password is not needed in this case).

  5. Start the service:

    sudo systemctl start syncnow

  6. Enable SyncNow to start on boot:

    sudo systemctl enable syncnow

Step 3: Verify Installation

  1. Open /opt/SyncNow/WebApp/app.json and enter the SyncNow hostname or IP address.

  2. Access SyncNow via:

    http://<server-ip>:5030

  3. Default login credentials:

    • Username: admin@SyncNow.Local
    • Password: Admin (Change this immediately after login)

  4. Enter your license key in the SyncNow application settings.

Uninstallation

  1. Ensure you have admin permissions.

  2. Run the following command to remove SyncNow:

    sudo ./Install.sh Remove

  3. SyncNow and its systemd service will be removed.

  4. If needed, delete the installation folder manually:

    sudo rm -rf /opt/SyncNow

Upgrade

SyncNow upgrades the database automatically during this process.

Upgrade Steps:

  1. Ensure you have admin permissions.

  2. Extract the new SyncNow archive to a temporary directory.

  3. Run the upgrade command:

    sudo ./Install.sh Upgrade /opt/SyncNow

  4. Confirm the backup prompt (Y).

  5. The upgrade process will update SyncNow while preserving essential configuration files.